マルペイDocs

※随時決済の「利用承諾のみ」「都度決済+利用承諾」は都度決済の各APIを利用して行います。
　そのため、「利用承諾のみ」「都度決済+利用承諾」の流れは都度決済と同様の流れとなります。
　但し、「利用承諾のみ」については、税送料計算の機能は利用できません。

決済の流れ（スマートフォン／ウェブ）

スマートフォンのブラウザを起点としたメルペイでの決済を行う際の流れです。

フローの説明

1. お客様がお支払い手段にメルペイを選択します。
2. 加盟店様は当サービスの取引登録（EntryTranMerpay）を行います。
3. 加盟店様は当サービスの決済実行（ExecTranMerpay）を行います。
4. 加盟店様はお客様を当サービスの支払手続き開始IF（MerpayStart）に誘導します。
5. お客様のブラウザ上から当サービスの支払手続き開始IF（MerpayStart）が行われ、
   お客様のスマートフォン上のメルカリアプリが起動します。
6. メルカリアプリが起動するとアクセス許可画面が表示されます。
7. お客様がアクセス許可に同意すると、注文画面が表示されます。
8. お客様はメルカリアプリ上で商品の配送先を選択します。
9. お客様が配送先を選択すると当サービスから税送料算出リクエストを通知します。
   加盟店様は配送先情報から税送料を算出し返却します。（お客様が配送先を選択する度に繰り返し呼ばれます）
10. お客様がメルカリアプリでお支払いを行います。
11. メルペイから当サービスに入金通知が送信されます。
    （結果通知プログラムをご利用の加盟店様へ当サービスから結果通知を送信します。）
12. メルカリアプリからお客様に決済完了の通知が送られます。
13. メルカリアプリから加盟店様の決済完了後の戻り先URLに遷移し決済結果が返却されます。

決済の流れ（スマートフォン／アプリ）

スマートフォンの加盟店様アプリを起点としたメルペイでの決済を行う際の流れです。

フローの説明

1. お客様がお支払い手段にメルペイを選択します。
2. 加盟店様は当サービスの取引登録（EntryTranMerpay）を行います。
3. 加盟店様は当サービスの決済実行（ExecTranMerpay）を行います。
4. 加盟店様はお客様をメルカリアプリに誘導します。
5. メルカリアプリが起動するとアクセス許可画面が表示されます。
6. お客様がアクセス許可に同意すると、注文画面が表示されます。
7. お客様はメルカリアプリ上で商品の配送先を選択します。
8. お客様が配送先を選択すると当サービスから税送料算出リクエストを通知します。
   加盟店様は配送先情報から税送料を算出し返却します。（お客様が配送先を選択する度に繰り返し呼ばれます）
9. お客様がメルカリアプリでお支払いを行います。
10. メルペイから当サービスに入金通知が送信されます。
    （結果通知プログラムをご利用の加盟店様へ当サービスから結果通知を送信します。）
11. メルカリアプリからお客様に決済完了の通知が送られます。
12. メルカリアプリから加盟店様の決済完了後の戻り先URLに遷移し決済結果が返却されます。

画面遷移イメージ（スマートフォン／ウェブ・アプリ）




決済の流れ（PC）

PCを起点としたメルペイでの決済を行う際の流れです。

sequenceDiagram お客様(PC)->>加盟店様: 1.メルペイでお支払い 加盟店様->>当サービス: 2.取引登録 当サービス-->>加盟店様:   加盟店様->>当サービス: 3.決済実行 当サービス-->>加盟店様:   加盟店様-->>お客様(PC):4.支払い手続き開始IFに誘導 当サービス-->>加盟店様: 結果通知(3.決済実行) お客様(PC)->>当サービス:5.支払い手続き開始 当サービス-->>お客様(PC):メルカリアプリへ誘導するQRコードを表示 opt QRコードリーダーで読み込む場合 お客様(PC)->>お客様(PC):6.QRコード読み取り お客様(PC)->>メルカリアプリ:7.メルカリアプリ起動 end opt メルカリアプリでQRを読み込む場合 メルカリアプリ->>お客様(PC):8.QRコード読み取り お客様(PC)-->>メルカリアプリ:   end opt 個人情報を利用する場合 メルカリアプリ-->>お客様(PC):アクセス許可画面 お客様(PC)->>メルカリアプリ:9.同意する メルカリアプリ-->>お客様(PC):注文画面表示 お客様(PC)->>メルカリアプリ:10.配送先選択 opt 配送先に応じて税送料を算出する場合 当サービス->>加盟店様:税送料算出 加盟店様-->>当サービス:11.税送料 end end メルカリアプリ-->>お客様(PC):注文画面表示 お客様(PC)->>メルカリアプリ:12.決済実行 メルペイ->>当サービス:13.入金通知 当サービス-->>加盟店様:結果通知（13.入金通知） メルカリアプリ-->>お客様(PC):14.決済完了通知 メルカリアプリ-->>当サービス:   当サービス-->>お客様(PC):加盟店様サイト（決済完了後の戻り先URL）にリダイレクト お客様(PC)->>加盟店様:15.決済結果受信 加盟店様-->>お客様(PC):画面表示

フローの説明

1. お客様がお支払い手段にメルペイを選択します。
2. 加盟店様は当サービスの取引登録（EntryTranMerpay）を行います。
3. 加盟店様は当サービスの決済実行（ExecTranMerpay）を行います。
4. 加盟店様はお客様を当サービスの支払手続き開始IF（MerpayStart）に誘導します。
5. お客様のブラウザ上から当サービスの支払手続き開始IF（MerpayStart）が行われ、
   お客様のブラウザに決済開始用のQRコードが表示されます。
6. お客様がスマートフォンのQRコードリーダーでQRコードを読み込みます。
7. お客様のスマートフォン上でメルカリアプリが起動しアクセス許可画面が表示されます。
8. お客様がメルカリアプリでQRコードをスキャンするとアクセス許可画面が表示されます。
9. お客様がアクセス許可に同意すると、注文画面が表示されます。
10. お客様はメルカリアプリ上で商品の配送先を選択します。
11. お客様が配送先を選択すると当サービスから税送料算出リクエストを通知します。
    加盟店様は配送先情報から税送料を算出し返却します。（お客様が配送先を選択する度に繰り返し呼ばれます）
12. お客様がメルカリアプリでお支払いを行います。
13. メルペイから当サービスに入金通知が送信されます。
    （結果通知プログラムをご利用の加盟店様へ当サービスから結果通知を送信します。）
14. メルカリアプリからお客様に決済完了の通知が送られます。
15. QRコードが表示されているページから加盟店様の決済完了後の戻り先URLに遷移し決済結果が返却されます。

画面遷移イメージ（PC）



決済の流れ（随時決済）

sequenceDiagram participant お客様 加盟店様->>当サービス: 1.取引登録 当サービス-->>加盟店様:   加盟店様->>当サービス: 2.決済実行 participant メルカリアプリ as メルカリアプリ 当サービス->>メルペイ: 3.決済申込処理 メルペイ-->>当サービス:   当サービス-->>加盟店様:   当サービス-->>加盟店様: 結果通知(2.決済実行)

フローの説明

1. 加盟店様は当サービスの取引登録（EntryTranMerpay）を行います。
2. 加盟店様は「利用承諾のみ」「都度決済+利用承諾」に発行されたサブスクリプションIDを指定し、
   当サービスの決済実行（ExecTranMerpay）を行います。
3. 当サービスがメルペイに対して決済申込処理を行い、加盟店様に決済の申込結果を返却します。

本書は、お客様が当サービスのメルペイの開発を円滑に進めることを目的にしています。